home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / bbs_util / inquis10.zip / INQUISIT.DOC < prev    next >
Text File  |  1994-07-20  |  11KB  |  194 lines
  1.                      The Inquisitor v1.00 by Cory Benjamin
  2.            Copyright (c) 1994 Mohawk Software.  All rights reserved.
  3.  
  4.                                      About:
  5.  
  6.      Have you ever wished you had one program that would pull out FILE_ID.DIZ
  7. or DESC.SDI descriptions from all known archive types, extract size information
  8. from graphics and sample rate/duration from sound files?  If so, keep reading.
  9. But first, the disclaimer:
  10.  
  11.                                   Requirements:
  12.  
  13.      The Inquisitor was made to run with RemoteAccess v2.0X.  It requires a
  14. PC compatible computer and MS or PC DOS V3.3 or higher.  Although not
  15. necessary, a disk-caching program will increase performance many times over.
  16. Because RAMGR itself takes alot of conventional memory, the more of that you
  17. have free, the better.
  18.  
  19.                                     Warranty:
  20.  
  21.      This program is not warranted in any way except that it will take up space
  22. on your hard drive (no promises on exactly how much, however).  Reasonable
  23. precautions have been taken to ensure that it will NOT: 1. Deplete the ozone
  24. layer and/or promote global warming; 2. Cause household pets to start wearing
  25. leather jackets; or 3. Create a scandal if you decide to run for President*.
  26.  
  27. * Unless, of course, you use it without registering or fail to pay Social
  28. Security for your hired help who use it on your system.
  29.  
  30.                                     License:
  31.  
  32.      You are granted a limited license to use this program for 30 days or to
  33. generate half of the descriptions on your BBS.  If you wish to use this program
  34. beyond the trial period you must register.  You may distribute this program
  35. freely in any archive form as long as INQUISIT.EXE, INQUISIT.DOC, INQUISIT.REG,
  36. INCONFIG.EXE and FILE_ID.DIZ are left unaltered and no charge is made for
  37. copies beyond routine access/copying fees.
  38.  
  39.                                    Operation:
  40.  
  41.      The Inquisitor is intended to retrieve information about as many types of
  42. files as is possible.  In addition, if it fails to find information in the
  43. file it's looking at, it will attempt to locate a FILES.BBS in the current
  44. directory.  If THAT fails, it will search the list file of your choice for a
  45. description.  I will explain The Inquisitor's operation by file type, or,
  46. optionally, FILES.BBS and/or search of another files list (user-specified,
  47. generally called an allfiles list).
  48.  
  49.                         Currently Supported File Types:
  50.  
  51. ARC/ARJ/DWC/HYP/LZH/PAK/RAR/SDA/SDN/SQZ/ZIP/ZOO: Attempt to retrieve
  52. FILE_ID.DIZ followed by DESC.SDI.  If not found, look for FILES.BBS and/or,
  53. optionally, search of another file list (user-specified).
  54.  
  55. LHA/ADS: Attempt to retrieve description for LHA from corresponding ADS file.
  56. If not found, attempt to retrieve FILE_ID.DIZ from LHA or description
  57. from FILES.BBS or file list (user-specified).
  58.  
  59. BMP/GIF/PCX/SCx/TGA: Insert size information at beginning of description,
  60. replacing existing size info if recognized.  Attempt to retrieve description
  61. from FILES.BBS or optional file list (user-specified) if no description exists.
  62.  
  63. NOTE:  The following SCx formats are recognized:
  64. 320x200x16  -SCD, 640 x200x16-SCE, 640x350x16 -SCR, 640x480x16 -SCP,
  65. 800x600x16  -SCG, 1024x768x16-SCU, 320x200x256-SCI, 320x400x256-SCK,
  66. 360x480x256 -SCQ, 640x400x256-SCL, 640x480x256-SCF, 800x600x256-SCN,
  67. 1024x768x256-SCO, Text       -SCZ. 640x350x256 is assumed to be SCW
  68. (not entirely sure).  Information and samples of other sizes would be
  69. greatly appreciated.
  70.  
  71. VOC/WAV: Insert sample rate, bits/sample and length (seconds) at beginning
  72. of description, replacing existing size info if recognized.  Attempt to
  73. retrieve description from FILES.BBS or optional file list (user-specified) if
  74. no description exists.
  75.  
  76. MOD (IBM/Amiga sound module): Retrieve title from file if no description
  77. exists.
  78.  
  79.                                  Configuration:
  80.  
  81.      Type INCONFIG.  A menu will appear where you can select the paths to the
  82. utilities Inquisitor needs to operate, the path and name of the optional
  83. ALLFILES listing and the options to attempt to read from .ADS, .SDA and
  84. FILES.BBS listings.  The bottom section allows you to select which file
  85. extensions you want Inquisitor to examine.  Use the arrow keys to navigate and
  86. ENTER to change a line.  Hit ESC to exit; your current configuration will be
  87. saved.  Important: INQUISIT and INCONFIG may be located anywhere in your
  88. path, however, they MUST be in the same directory.
  89.  
  90.      Notes:
  91.         If you enter an editor name, and have .ADS and .SDA retrieval turned
  92.      on, your editor will pop up every time it encounters such a file.  This
  93.      is because these .ADS and .SDA descriptions can be very large.  If you
  94.      want the whole thing imported, however, just leave the edit field blank.
  95.         The offset information in the files.bbs/allfiles menu means this:
  96.      Type in the number of the column in your files.bbs or allfiles where the
  97.      name or description is.  Example for a allfiles list:
  98.  
  99.               11111111112222222222333
  100.      12345678901234567890123456789012
  101.      INQUIS10.ZIP   07-20-94  20000 Inquisitor 1.00.
  102.      |                              |
  103.      Name offset (1)                Description offset (32)
  104.  
  105.                  ** THE MAGIC KEY TO GET INTO INCONFIG IS ^ **
  106.  
  107.                            Configuring Remote Access:
  108.  
  109.      RACONFIG -> OPTIONS -> FILES -> RAMGR FnKeys:  After selecting the FnKey
  110. you want to use, enter the following:  [PATH]INQUISIT @ #, where # should be
  111. replaced with the number of the FnKey you chose.  Notice that Inquisitor
  112. can run under any of the 5 FnKeys, as long as you tell it which one
  113. you are using!  (Note the example below.)
  114.  
  115. NOTE: If you have a very large file database, RAMGR will hog up a lot of
  116. precious memory that Inquisitor needs to run your archiving programs with.  If
  117. this is the case, add *m to the end of the command line, which will tell RAMGR
  118. to shell some of its memory to disk, giving Inquisitor its necessary memory. 
  119. Some archivers, particularily RAR, require a lot more memory than others.  If
  120. you have a disk-caching program loaded, the added delay with adding *m will be
  121. minimal...
  122.  
  123.          File        System        Options        Modem        Manager          
  124. ═╒════════ File options ╕═════════╒══════════════╕══════════════════════════════
  125. ▒│                      │▒▒▒▒▒▒▒▒▒│ Messages     │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  126. ▒│ Upload credit  60    │▒▒▒▒▒▒▒▒▒│ Files        │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  127. ▒│ Payback credit 50    │▒▒▒▒▒▒▒▒▒│ Restrictions │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  128. ▒│ Touch dates    Yes   │▒▒▒▒▒▒▒▒▒│ Errorlevels  │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  129. ▒│ Sho╒══════════════════════════════════ RAMGR ALT-function key manager ╕▒▒▒▒▒▒
  130. ▒│ Upl│                                                                  │▒▒▒▒▒▒
  131. ▒│ Log│ 1  c:\batch\shez\shez.exe @ *m                                   │▒▒▒▒▒▒
  132. ▒│ New│ 2                                                                │▒▒▒▒▒▒
  133. ▒│ Dow│ 3  c:\ra\inquisit.exe @ 3                                        │▒▒▒▒▒▒
  134. ▒│ Dow│ 4  c:\batch\vpic\vpic.exe @ /m4                                  │▒▒▒▒▒▒
  135. ▒│ Dow│ 5  c:\ra\put-diz.com c:\ra\kis pkzip -ao @                       │▒▒▒▒▒▒
  136. ▒│ No │                                                                  │▒▒▒▒▒▒
  137. ▒│ DL ╘══════════════════════════════════════════════════════════════════╛▒▒▒▒▒▒
  138. ▒│ List format          │▒▒▒▒ All Rights Reserved ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  139. ▒│ Missing format       │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  140. ▒│ Upload scan          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  141. ▒│ RAMGR FnKeys         │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  142. ▒│ Ext arcview          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  143. ▒│ Archivers            │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  144. ▒│                      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  145. ▒╘══════════════════════╛▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  146. ────────────────────────────────────────────────────────────────────────────────
  147.  
  148.                                Using Inquisitor:
  149.  
  150.      Run RAMGR, enter a file area and press ALT and the function key you
  151. selected.  The Inquisitor will scan all files below the cursor.  You may abort
  152. at any time by pressing CTRL-ALT.  You may also change configuration on-the-fly
  153. by pressing CTRL-SHIFT; this will load INCONFIG.  Anything you change in
  154. INCONFIG will be activated from that point on.  NOTE: Until the registration
  155. key is entered, you will have to press ENTER as each file is scanned.  As soon
  156. as you register, it will AUTOMATICALLY go down your whole file area!!!
  157.  
  158.                          Registration and Bug Reports:
  159.  
  160.      Send $7.00 (plus applicable tax for NY residents) by check or money order
  161. (money orders will be processed faster) along with your name EXACTLY as entered
  162. in RACONFIG to Toby Marsh (distributor) at the address below.  Your key
  163. information and instructions will be sent by netmail or snailmail if no net
  164. address is given.  Questions and comments may be netmailed to Toby Marsh or Cory
  165. Benjamin (the author) c/o Catfish Mecca, FIDO 1:2609/14, 315-336-8948.  I also
  166. belong to AtariNet, DoorNet, GodNet, ITCNet and SKYNet; the addresses are listed
  167. below.  Mail addressed to Cory via one of these nodes should reach him within 24
  168. hours.
  169.  
  170.      If you encounter a file that The Inquisitor doesn't recognize, please send
  171. the file along with your bug report.
  172.  
  173.                                   Known bugs:
  174.  
  175.      A few people have complained about Inquisitor having a rough time handling
  176. large allfiles lists (over 2 megs).  I have been unable to recreate any of these
  177. errors (I made a 15 meg allfile list and ran Inquisitor with 282k of memory
  178. before running RAMgr), and it worked fine.  However, with the delicate nature
  179. of interfacing between RAMgr, archiving programs, etc..., things can happen.
  180. If you find a problem, please let me know...  Before reporting to me, see
  181. if the file "$IMPORT$.IMP" exists in your RA directory.  If it does, try
  182. deleting that and see if it fixes the problem.  This is a temporary file that
  183. should be deleted by Inquisitor, but can hang around under certain conditions.
  184. Although problems can happen here and there, I hope you enjoy the basic
  185. workability of The Inquisitor.
  186.  
  187.           Toby J. Marsh                           Catfish Mecca
  188.           RFD 6 - Box 311                         FidoNet:  1:2609/14
  189.           Rome, NY 13440                          AtariNet: 51:4/5
  190.                                                   DoorNet:  75:7315/109
  191.                                                   GodNet:   143:315/1336
  192.                                                   ITCNet:   85:860/507
  193.                                                   SKYNet:   375:315/5
  194.